* Restructure MCP overview page (#354)

- Replace sparse overview with full client setup guide (Cursor, VS Code,
  Claude Code, Claude Desktop, Windsurf, ChatGPT, Other) using tabbed layout
- Expand available tools from 8 to 147, grouped by category in collapsible
  sections with pinned/destructive indicators
- Fix QueryData → SearchSQL with correct argument shape (org_id,
  request_body.query, start_time/end_time in epoch microseconds)
- Add collapsible troubleshooting blocks and multi-org workflow section
- Add security considerations section
- Fold "What is MCP?" into the opening paragraphs
- Fix O2_TOOL_API_URL note for non-local deployments
- Replace broken ChatGPT doc link; fix claude /mcp → claude mcp list

Co-authored-by: Gorakhnath Yadav <gorakh-work@Gorakhnaths-MacBook-Pro.local>

* docs: remove ZO_COMPACT_OLD_DATA_MIN_RECORDS, clarify ZO_COMPACT_OLD_DATA_MIN_FILES (#358)

* adding index pages (#357)

Co-authored-by: Gorakhnath Yadav <gorakh-work@Gorakhnaths-MacBook-Pro.local>

* docs: AI integration amazon bedrock (#359)

* add: rum source map docs (#360)

* adding the plugin (#361)

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* docs: Adding hook for .md pages (#362)

* adding the plugin

* added the custom hook

---------

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* fix: link of migrate file list partitiion (#364)

* refactor: remove feedback form and associated styles from footer (#365)

* docs: rework Enterprise install guides and lift into top-level Enterp… (#363)

* docs: rework Enterprise install guides and lift into top-level Enterprise Setup section

Restructures the Enterprise install docs (EKS, AKS, GKE) for clarity and consistency, and lifts them out from under Production Setups → Enterprise into a top-level Enterprise Setup section.

Structure and nav:
- New top-level Enterprise Setup section at docs/enterprise-setup/ with Overview, Amazon EKS, Azure AKS, Google GKE, SRE Agent Setup, Enterprise Features, License and Pricing, Capacity Planning, Performance.
- Removes the old Production Setups wrapper (including the unfinished Open Source subgroup) from the nav.
- Moves capacity-planning, performance, and sre-agent (was sre-agent-setup-guide) under enterprise-setup; deletes the old redundant openobserve-enterprise-edition-installation-guide and sre-agent-setup-guide pages from Administration → Deployment.
- Updates 4 incoming links in user-guide pages.

Install guide rewrite (EKS, AKS, GKE):
- Per-step structure: Commands → Verify (collapsible) containing Verification step + Expected output + nested Troubleshooting (Step N).
- Each install step wrapped in its own collapsible at the page level.
- Single consolidated Troubleshooting reference collapsible at the bottom of each guide; entries are bullet items grouped by theme; duplicates merged across steps.
- Standardized post-install template across all three pages: Load Sample Data, Search Your Data, Next Steps - Send Your Own Data.
- Teardown wrapped in its own collapsible on every page.
- Removed em/en dashes throughout and any horizontal-rule separators between sections; no AI-style hedging.

EKS-specific fixes:
- Adds env-var export block at top of Step 1 CLI tab so $CLUSTER_NAME / $AWS_REGION / $NAMESPACE are set before use.
- Replaces inaccurate Console "Manage OIDC provider" step with the correct eksctl associate-iam-oidc-provider one-liner.
- Adds an EBS CSI driver install step to the Console path.
- Corrects the bucket.sh trust-policy description (it only enforces :aud, not the service-account :sub).
- Replaces the AmazonEKSClusterPolicy advice with a link to eksctl's minimum IAM policies.
- Adds yq v4 to the prereqs table and the verify block.
- Makes credentials consistent across Step 4, the curl verify, and Load Sample Data (you@yourcompany.com / ChangeMe#123).
- Removes the kubectl wait for=condition=Ready check that misses CNPG-managed pods.
- Corrects the sample-data verification response shape to {"code":200,"status":[{...}]}.

AKS-specific fixes:
- Trims the Prerequisites: drops the 4-step Portal walkthrough, the Verify-before-continuing block, the Poll-until-registered prose, and the trailing horizontal rule; folds login + RP registration into a single block.
- Simplifies the Step 1/2/5 Verify commands: bare az ... show instead of --query "{...}" -o table.
- Tightens the Step 7 Verify grep to AZURE_STORAGE_ACCOUNT_(NAME|KEY), ZO_NATS_REPLICAS:, instances: 2, enabled: true.
- Corrects the sample-data response shape and the subscription-eligibility claim (Free Trial/Student/MSDN can request via support ticket but not self-serve from the Quotas page).
- Lifts the Cleanup block out of the troubleshooting reference into a top-level Teardown section.

GKE-specific fixes:
- Trims the Prerequisites: drops the Verify-before-continuing block, the trailing horizontal rule, and the Homebrew gke-gcloud-auth-plugin warning (now in TS reference); compresses the 3-step Console project walkthrough into one sentence; rewrites the SSD-quota section (requires >=1000 GB, drops the 500 GB / 20 GiB PVC option from prerequisites) and adds the shrink-to-20Gi fallback as a path in the troubleshooting entry.
- Folds Step 8 (wait for pods to come up) into Step 7's Verify; renumbers former Step 9 to Step 8.
- Splits the architecture-overview Dex/OpenFGA bullet into two (OpenFGA enabled by default; Dex optional/disabled by default).
- Adds a Step 1 cost note (~$290/month for 3x e2-standard-4 in us-central1).
- Moves the "HMAC secret shown once" warning out of the Verify block into a top-level callout right after the CLI/Console tabs.
- Broadens the Teardown disk-orphan check to all disks in $REGION and sweeps pvc-* leftovers.
- Corrects the sample-data response shape and credentials.

CSS:
- extra.css: minor padding fix for sidebar chevron alignment.

* resolving-comments

---------

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* added-content (#366)

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* enterprise free limit change (#367)

* updated license registration limit (#368)

Co-authored-by: Manas Sharma <manassharma@Manass-MacBook-Pro.local>

* docs: rewrite top-traffic pages to gold-docs standard (#369)

Applies a consistent gold-docs treatment across the highest-traffic pages:
frontmatter titles, single H1, "Need some help?" footer block, inline
admonitions for warnings/tips, "Next steps" sections, cleaner internal
links (.md extensions, no self-references), and removal of em dashes
and section-separator artifacts.

Pages updated:
- docs/getting-started.md: cloud + self-hosted setup now nested inside
  their respective tabs; sample-data and search sections cleaned up.
- docs/architecture.md: intro paragraph, durability section broken into
  hooks, components reordered (Router -> Ingester -> Compactor ->
  Querier -> AlertManager), <img> tags switched to attr-list image
  syntax, Next steps added.
- docs/ingestion/logs/otlp.md: H1 added, placeholder host instead of
  staging URL, HTTP vs gRPC differentiator, prereqs, base64 auth note,
  trailing-slash warning, verify-ingestion section.
- docs/administration/deployment/ha-deployment.md: linear flow
  (prereqs -> values.yaml -> storage -> metadata -> NATS -> install ->
  verify -> uninstall), cnpg operator moved to prereqs, verify section
  with expected output, video walkthroughs in tip admonitions, heading
  casing fixed, mysuperduperbucket -> <your-bucket>.
- docs/administration/configuration/environment-variables.md: H1 +
  title frontmatter, "How to set these variables" intro, broken
  ZO_MEM_TABLE_BUCKET_NUM table cell fixed, 419 lines of dead-code
  HTML comments removed, Next steps added.
- docs/user-guide/data-exploration/example-queries.md: title frontmatter,
  "Before you start" note (stream name + filter-expr vs SQL distinction),
  "Avoid using..." warnings converted to !!! warning admonitions, Next
  steps.
- docs/features/logs.md: full frontmatter, image swaps (full-text-search
  and index pngs no longer reuse log-settings), asset rename
  log-feilds-detection.png -> log-fields-detection.png, Fluent Bit
  spelling, Get started + Next steps.
- docs/user-guide/analytics/dashboards/dashboards-in-openobserve.md:
  H1 + title, video wrapped in tip admonition, chart-types list
  renumbered 1-19, FAQ reformatted with two additional Q&As, multi-tab
  example screenshots placed in a flex container side-by-side.
- docs/user-guide/data-exploration/logs/logs.md: frontmatter, H1,
  self-referencing link removed, external docs links replaced with
  internal relatives, Dashboards/Alerts Next Steps links fixed, alt
  text standardized, <br> stripped.
- docs/user-guide/data-exploration/logs/index.md: full frontmatter +
  H1 + Next steps + footer.
- docs/ingestion/index.md: .md extensions added to every internal link
  (removes a large batch of mkdocs warnings), Fluent Bit / TypeScript
  spelling, traces OTEL link now points to traces/opentelemetry.md.

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix: revamped remaining top traffic pages (#370)

* changes

* changed default global retention

---------

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* add: revamped docs homepage (#371)

* phase 3: sidebar redesign

Enable navigation.sections so top-level groups render as labels. Add a
Jinja-driven section chip at the top of the primary sidebar (reads
page.ancestors). Replace the 4px active-state bar with a subtle
purple-tinted pill matching Supabase's pattern.

Files:
- mkdocs.yml: add navigation.sections feature
- overrides/partials/nav.html: override Material's nav.html, include chip
- overrides/partials/section-chip.html: new Jinja partial
- docs/stylesheets/extra.css: Phase 3 CSS block (section labels, active
  pill, chip), bracketed with phase markers per rollback strategy

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Revert "phase 3: sidebar redesign"

This reverts commit e70f610.

* reworked-homepage

* refactor: clean up CSS and HTML structure for improved readability and maintainability

* Refactor CSS and HTML structure for improved readability and maintainability

- Updated CSS classes to remove unused styles and adjust positioning values.
- Cleaned up HTML by formatting and organizing elements for better clarity.
- Enhanced accessibility attributes and improved semantic structure in the HTML.
- Consolidated similar elements and reduced redundancy in class usage.

* fix: adjust sidebar and header positioning for consistent layout

* refactor: enhance button styles and improve header layout for better UX

---------

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: krupa <krupa.jivani@kiara.tech>

* docs: add ZO_CORS_ALLOWED_ORIGINS environment variable (#375)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: add ZO_HTTP_REAL_IP_SOURCE environment variable (#376)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* update file list migration (#377)

* docs: add comparison-with-alternatives section and per-page LLM actions (#373)

* docs: add comparison-with-alternatives section and per-page LLM actions

- Restructure docs/overview into a Comparison with Alternatives section
  with four pages: Elasticsearch (existing, unchanged), Splunk, New Relic,
  and Datadog
- Add a per-page Copy / View / ChatGPT / Claude dropdown in the right TOC
  (docs/js/llm-page-actions.js + docs/stylesheets/llm-page-actions.css),
  hardened against Material instant-navigation orphan-menu accumulation
- Fix the mkdocs-llmstxt Migration glob to recurse (migration/**/*.md)
  so nested migration guides are picked up

* docs(splunk): clarify 140x storage efficiency translates to lower cost

---------

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

* update file list migration (#378)

* fix: file list migration (#379)

* corrected-broken-links (#372)

Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>

---------

Co-authored-by: GORAKHNATH YADAV <gorakhcodes@gmail.com>
Co-authored-by: Gorakhnath Yadav <gorakh-work@Gorakhnaths-MacBook-Pro.local>
Co-authored-by: Hengfei Yang <hengfei.yang@gmail.com>
Co-authored-by: Simran Kumari <60690997+simranquirky@users.noreply.github.com>
Co-authored-by: Gorakh Nath Yadav <gnyadav@openobserve.ai>
Co-authored-by: Prabhat Sharma <hi.prabhat@gmail.com>
Co-authored-by: Manas Sharma <manassharma7268@gmail.com>
Co-authored-by: Manas Sharma <manassharma@Manass-MacBook-Pro.local>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>